Deprecate gtk_widget_get_root_window

The root window is a fairly X-centric concept, and it
really has no place in the GtkWidget API. Plus, this
is a rarely-used one-line convenience function with
poor documentation.

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 896ff398e60d5335bb2113f38a2724276960f09e..f4246ac7ccf876374ed9aaf78e5efed7c8640a62 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -10177,7 +10177,9 @@ gtk_widget_get_display (GtkWidget *widget)
  * Return value: (transfer none): the #GdkWindow root window for the toplevel for this widget.
  *
  * Since: 2.2
- **/
+ *
+ * Deprecated: 3.12: Use gdk_screen_get_root_window() instead
+ */
 GdkWindow*
 gtk_widget_get_root_window (GtkWidget *widget)
 {

diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 0a657a742196c3eb06230ea8e2f5c33fc9b075a7..1f6318f6e966c16a6625cc4c180dd30112ea752a 100644 (file)
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -1010,7 +1010,7 @@ GDK_AVAILABLE_IN_3_10
 gint          gtk_widget_get_scale_factor (GtkWidget *widget);
 GDK_AVAILABLE_IN_ALL
 GdkDisplay *  gtk_widget_get_display     (GtkWidget *widget);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_12
 GdkWindow *   gtk_widget_get_root_window (GtkWidget *widget);
 GDK_AVAILABLE_IN_ALL
 GtkSettings*  gtk_widget_get_settings    (GtkWidget *widget);